home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_html2ps.idb / usr / freeware / catman / u_man / cat5 / html2psrc.Z / html2psrc
Encoding:
Text File  |  1999-01-26  |  46.6 KB  |  1,321 lines
  1.  
  2.  
  3.  
  4.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       html2psrc - configuration file format    for html2ps(1)
  10.  
  11.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.       Configuration    files are used for layout control, resource
  13.       information etc. Normally, there should always exist a
  14.       global configuration file.  In this file one typically
  15.       specify things like: what image conversion packages are
  16.       available on the system, the default paper size, the default
  17.       text fonts and sizes,    etc.
  18.  
  19.       For Unix systems, the    installation script 'install' can be
  20.       used to automatically    build a    global configuration file with
  21.       all necessary    definitions, and install all files. The    files
  22.       replaced by the installation are saved. If you for some
  23.       reason are not satisfied with    the new    version:  execute the
  24.       script 'backout' to reinstall    your earlier version.
  25.  
  26.       On non-Unix systems, you will    have to    manually create    a
  27.       global configuration file, and insert    the name of this file
  28.       into the html2ps script (close to the    beginning, the line
  29.       starting with    "$globrc="). The configuration file should
  30.       contain a package block, and perhaps paper and hyphenation
  31.       blocks, described below.
  32.  
  33.       Each user can    then have a personal configuration file    (by
  34.       default $HOME/.html2psrc) that complements/overrides the
  35.       definitions made in the global file. It is also possible to
  36.       specify alternative files on the command line, using the -f
  37.       option.
  38.  
  39.      FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT
  40.       A configuration file can include other configuration files.
  41.       This is done with:
  42.  
  43.          @import "_f_i_l_e_n_a_m_e";
  44.  
  45.       The rest of the configuration    file consists of zero or more
  46.       blocks.  A block is given by a block name, followed by the
  47.       block    definition, as in:
  48.  
  49.          BODY {
  50.            font-size: 12pt;
  51.            font-family: Helvetica;
  52.            text-align: justify
  53.          }
  54.  
  55.       The block definition,    enclosed by curly braces: { },
  56.       consists of key-value    pairs and/or other blocks. A key-value
  57.       pair consists    of the key name    followed by a colon, followed
  58.       by the value.    Blocks and key-value pairs are separated by
  59.       semicolons. The semicolon may    be omitted after a block.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 12/10/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  71.  
  72.  
  73.  
  74.       Several blocks can share the same definition.    The block
  75.       names    are then separated be commas, as in:
  76.  
  77.          H2, H4, H6    { font-style: italic }
  78.  
  79.       A comment in a configuration file starts with    the characters
  80.       "/*" and ends    with "*/":
  81.  
  82.          @html2ps {
  83.            seq-number: 1;  /* Automatic numbering of headings */
  84.          }
  85.  
  86.       Notations
  87.  
  88.       Here are some    definitions of terms used below:
  89.  
  90.            FFFFllllaaaagggg::::
  91.             A value of either 0    (absence, inactive etc)    or 1
  92.             (presence, active etc).
  93.            AAAAbbbbssssoooolllluuuutttteeee    ssssiiiizzzzeeee::::
  94.             A real number optionally followed by one of    the
  95.             following two-letter unit identifiers: cm
  96.             (centimeters), mm (millimeters), in    (inches), pt
  97.             (points, 1pt = 1/72    inch), pc (picas, 1pc =    12pt).
  98.             The    default    unit is    centimeters.
  99.            RRRReeeellllaaaattttiiiivvvveeee    ssssiiiizzzzeeee::::
  100.             A size relative to current fontsize. The default
  101.             and    currently only recognized unit is em. One em
  102.             equals the size of the current font.  The value
  103.             should be given as a real number, optionally
  104.             followed by    'em', as in '0.25em'.
  105.            WWWWhhhhiiiitttteeeessssppppaaaacccceeee::::
  106.             Any    one of the characters: space, tab, newline, or
  107.             carriage return.
  108.  
  109.       CSS1 blocks
  110.  
  111.       All blocks, except one: the @html2ps block, coincides    with a
  112.       subset of the    CSS1 - Cascading Style Sheets level 1 -
  113.       specification    (http://www.w3.org/pub/WWW/TR/PR-CSS1).     (If
  114.       this link is no longer valid,    try looking for    style sheet
  115.       documentation    starting at the    W3C (http://www.w3.org/) home
  116.       page.)
  117.  
  118.       The following    default    settings for html2ps illustrate    just
  119.       about    everything that    currently can be used from the CSS1
  120.       specification:
  121.  
  122.          BODY {
  123.            font-family: Times;
  124.            font-size: 11pt;
  125.            text-align: left;
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 12/10/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  137.  
  138.  
  139.  
  140.            background: white;
  141.          }
  142.  
  143.          H1, H2, H3, H4, H5, H6 {
  144.            font-weight: bold;
  145.            margin-top: 0.8em;
  146.            margin-bottom: 0.5em;
  147.          }
  148.          H1    { font-size: 19pt }
  149.          H2    { font-size: 17pt }
  150.          H3    { font-size: 15pt }
  151.          H4    { font-size: 13pt }
  152.          H5    { font-size: 12pt }
  153.          H6    { font-size: 11pt }
  154.  
  155.          P,    OL, UL,    DL, BLOCKQUOTE,    PRE {
  156.            margin-top: 1em;
  157.            margin-bottom: 1em;
  158.          }
  159.  
  160.          P {
  161.            line-height: 1.2em;
  162.            text-indent: 0;
  163.          }
  164.  
  165.          OL, UL, DD    { margin-left: 2em }
  166.  
  167.          TT, KBD, PRE { font-family: Courier }
  168.  
  169.          PRE { font-size: 9pt }
  170.  
  171.          BLOCKQUOTE    {
  172.            margin-left: 1em;
  173.            margin-right: 1em;
  174.          }
  175.  
  176.          ADDRESS {
  177.            margin-top: 0.5em;
  178.            margin-bottom: 0.5em;
  179.          }
  180.  
  181.          TABLE {
  182.            margin-top: 1.3em;
  183.            margin-bottom: 1em;
  184.          }
  185.  
  186.          DEL { text-decoration: line-through }
  187.  
  188.          A:link, HR    { color: black }
  189.  
  190.       The program specific block @_h_t_m_l_2_p_s:
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 12/10/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  203.  
  204.  
  205.  
  206.       This block is    used to    specify    parameters that    are specific
  207.       to html2ps, and not covered by CSS1. The @html2ps  block has
  208.       several sub-blocks and key-value pairs, these    are described
  209.       in this section.
  210.  
  211.       The _p_a_c_k_a_g_e block
  212.            This block is used to specify which program packages
  213.            are installed on    the system. Typically, this is done in
  214.            the global configuration    file.
  215.  
  216.            PPPPeeeerrrrllllMMMMaaaaggggiiiicccckkkk
  217.             A flag specifying whether the Perl module
  218.             PerlMagick is installed or not. The    default    is 0.
  219.  
  220.            IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk
  221.             A flag specifying whether the ImageMagick package
  222.             is installed or not. The default is    0.
  223.  
  224.            ppppbbbbmmmmpppplllluuuussss
  225.             A flag specifying whether the pbmplus package is
  226.             installed or not. The default is 0.
  227.  
  228.            nnnneeeettttppppbbbbmmmm
  229.             A flag specifying whether the netpbm package is
  230.             installed or not. The default is 0.
  231.  
  232.            ddddjjjjppppeeeegggg
  233.             A flag specifying whether djpeg is installed or
  234.             not.  The default is 0.
  235.  
  236.            GGGGhhhhoooossssttttssssccccrrrriiiipppptttt
  237.             A flag specifying whether Ghostscript is installed
  238.             or not.  The default is 0.
  239.  
  240.            TTTTeeeeXXXX  A flag specifying whether the TeX package is
  241.             installed or not.  The default is 0.
  242.  
  243.            ddddvvvviiiippppssss
  244.             A flag specifying whether dvips is installed or
  245.             not.  The default is 0.
  246.  
  247.            lllliiiibbbbwwwwwwwwwwww----ppppeeeerrrrllll
  248.             A flag specifying whether the Perl module library
  249.             libwww-perl    is installed or    not. The default is 0.
  250.  
  251.            jjjjffffrrrriiiieeeeddddllll
  252.             A flag specifying whether the Perl scripts www.pl
  253.             and    network.pl (by Jeffrey Friedl) are installed
  254.             or not. The    default    is 0.
  255.  
  256.            ggggeeeettttuuuurrrrllll
  257.             When neither of the    Perl packages for retrieving
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 12/10/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  269.  
  270.  
  271.  
  272.             remote documents are available, it is possible to
  273.             use    some other program like    lynx or    url_get. This
  274.             value should be set    to a command that retrieves a
  275.             document with a complete MIME header, such as
  276.             "lynx -source -mime_header"    or "url_get -h".
  277.  
  278.            cccchhhheeeecccckkkk
  279.             The    name of    a program used for syntax checking
  280.             HTML documents.  No    default, a good    choice is
  281.             weblint.
  282.  
  283.            ppppaaaatttthhhh A colon separated list of directories where    the
  284.             executables    from the program packages are. It is
  285.             only necessary to include directories that are not
  286.             in the PATH    for a typical user.
  287.  
  288.       The _p_a_p_e_r block
  289.            The paper size is defined in this block.    The size can
  290.            either be given as one of the recognized    paper types or
  291.            by giving explicit values for the paper height and
  292.            width.
  293.  
  294.            ttttyyyyppppeeee Paper type,    possible choices are: A0, A1, A2, A3,
  295.             A4,...,A10,    B0, B1,...,B10,    letter,    legal, arche,
  296.             archd, archc, archb, archa,    flsa, flse,
  297.             halfletter,    11x17, and ledger (this    set of paper
  298.             types is taken from    Aladdin    Ghostscript). The
  299.             default is A4.
  300.  
  301.            hhhheeeeiiiigggghhhhtttt
  302.             An absolute    size specifying    the paper height.
  303.  
  304.            wwwwiiiiddddtttthhhh
  305.             An absolute    size specifying    the paper width.
  306.  
  307.       The _o_p_t_i_o_n block
  308.            This block is used to set default values    for the
  309.            command line options. The key in    the key-value pair is
  310.            the option name,    in either its long or short form.
  311.  
  312.            ttttwwwwoooouuuupppp
  313.             Two    column (2-up) output. The default is one
  314.             column per page.
  315.  
  316.            bbbbaaaasssseeee Use    _U_R_L as a base to expand    relative references
  317.             for    in-line    images.    This is    useful if you have
  318.             downloaded a document to a local file.  The    _U_R_L
  319.             should then    be the _U_R_L of the original document.
  320.  
  321.            cccchhhheeeecccckkkk
  322.             Check the syntax of    the HTML file (using an
  323.             external syntax checker). The default is to    not
  324.  
  325.  
  326.  
  327.      Page 5                        (printed 12/10/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  335.  
  336.  
  337.  
  338.             make a syntax check.
  339.  
  340.            ttttoooocccc  Generate a table of    contents (ToC).    The value
  341.             should be a    string consisting of one of the
  342.             letters 'f', 'h', or 't', optionally combined with
  343.             the    letter 'b':
  344.  
  345.             bbbb     The ToC will be printed first.    This requires
  346.              that Ghostscript is installed.
  347.             ffff     The ToC will be generated from    the links in
  348.              the converted document.
  349.             hhhh     The ToC will be generated from    headings and
  350.              titles    in the converted documents. Note that
  351.              if the    document author    for some strange
  352.              reason    has chosen to use some other means to
  353.              represent the headings    than the HTML elements
  354.              H1,...,H6, you    are out    of luck!
  355.             tttt     The ToC will be generated from    links having
  356.              the attribute rev=TOC in the converted
  357.              document.
  358.  
  359.            ddddeeeebbbbuuuugggg
  360.             Generate debugging information. You    should always
  361.             use    this option when reporting problems with
  362.             html2ps.
  363.  
  364.            DDDDSSSSCCCC  Generate DSC compliant PostScript. This requires
  365.             Ghostscript    and can    take quite some    time to    do.
  366.             Note that a    PostScript file    generated with this
  367.             option cannot be used as input to html2ps for
  368.             reformatting later.
  369.  
  370.            eeeennnnccccooooddddiiiinnnngggg
  371.             The    document encoding. Currently recognized    values
  372.             are    ISO-8859-1, EUC-JP, SHIFT-JIS, and ISO-2022-JP
  373.             (other EUC-xx encodings may    also work). The
  374.             default is ISO-8859-1.
  375.  
  376.            rrrrccccffffiiiilllleeee
  377.             A colon separated list of configuration file names
  378.             to use instead of the default personal
  379.             configuration file $HOME/.html2psrc.  Definitions
  380.             made in one    file override definitions in previous
  381.             files (the last file in the    list has highest
  382.             precedence). An empty file name (as    in ':file',
  383.             'file1::file3', or 'file:')    will expand to the
  384.             default personal file. The environment variable
  385.             HTML2PSPATH    is used    to specify the directories
  386.             where to search for    these files. (Note:  this is
  387.             only supposed to be    used on    the command line, not
  388.             in a configuration file.)
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                        (printed 12/10/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  401.  
  402.  
  403.  
  404.            ffffrrrraaaammmmeeee
  405.             Draw a frame around    the text on each page. The
  406.             default is to not draw a frame.
  407.  
  408.            ggggrrrraaaayyyyssssccccaaaalllleeee
  409.             Convert colour images to grayscale images. Note
  410.             that the PostScript    file will be smaller when the
  411.             images are converted to grayscale. The default is
  412.             to generate    colour images.
  413.  
  414.            hhhheeeellllpppp Show usage information.
  415.  
  416.            hhhhyyyypppphhhheeeennnnaaaatttteeee
  417.             Hyphenate the text.    This requires TeX hyphenation
  418.             pattern files.
  419.  
  420.            ssssccccaaaalllleeeeiiiimmmmaaaaggggeeee
  421.             Scale in-line images with a    factor _n_u_m.  The
  422.             default is 1.
  423.  
  424.            llllaaaannnngggguuuuaaaaggggeeee
  425.             Specifies the language of the document (overrides
  426.             an eventual    LANG attribute of the BODY element).
  427.             The    language should    be given according to RFC1766
  428.             (ftp://ftp.nordu.net/rfc/rfc1766.txt) and ISO 639
  429.             (http://www.sil.org/sgml/iso639a.html).
  430.  
  431.            llllaaaannnnddddssssccccaaaappppeeee
  432.             Generate code for printing in landscape mode. The
  433.             default is portrait    mode.
  434.  
  435.            ssssccccaaaalllleeeemmmmaaaatttthhhh
  436.             Scale mathematical formulas    with a factor _n_u_m.
  437.             The    default    is 1.
  438.  
  439.            nnnnuuuummmmbbbbeeeerrrr
  440.             Insert page    numbers. The default is    to not number
  441.             the    pages.
  442.  
  443.            ssssttttaaaarrrrttttnnnnoooo
  444.             Specifies the starting page    number,    the default is
  445.             1.
  446.  
  447.            oooouuuuttttppppuuuutttt
  448.             Write the PostScript code to _f_i_l_e. The default is
  449.             to write to    standard output.
  450.  
  451.            oooorrrriiiiggggiiiinnnnaaaallll
  452.             Use    PostScript original images if they exist. For
  453.             example, if    a document contains an image
  454.             figure.gif,    and an encapsulated PostScript file
  455.             named figure.ps exists in the same directory, that
  456.  
  457.  
  458.  
  459.      Page 7                        (printed 12/10/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  467.  
  468.  
  469.  
  470.             file will be use instead. This only    work for
  471.             documents read as local files. Note:  if the
  472.             PostScript file is large or    contains bitmap
  473.             images, this must be combined with the -D option.
  474.             In HTML 4.0    this can be achieved in    a much better
  475.             way    with:
  476.  
  477.           <OBJECT data="figure.ps"
  478.           type="application/postscript">
  479.            <OBJECT data="figure.gif" type="image/gif">
  480.             <PRE>[Maybe    some ASCII art for text
  481.             browsers]</PRE>
  482.            </OBJECT>
  483.           </OBJECT>
  484.  
  485.            rrrroooooooottttddddiiiirrrr
  486.             When a document is read from a local file, this
  487.             value specifies a base directory for resolving
  488.             relative links starting with "/".  Typically, this
  489.             should be the directory where your web server's
  490.             home page resides.
  491.  
  492.            xxxxrrrreeeeffff Insert cross references at every link to within
  493.             the    set of converted documents.
  494.  
  495.            ssssccccaaaalllleeeeddddoooocccc
  496.             Scale the entire document with a factor _n_u_m.  The
  497.             default is 1.
  498.  
  499.            ssssttttyyyylllleeee
  500.             This option    complements/overrides definitions made
  501.             in the configuration files.    The _s_t_r_i_n_g must    follow
  502.             the    configuration file syntax. (Note: this is only
  503.             supposed to    be used    on the command line, not in a
  504.             configuration file.)
  505.  
  506.            tttteeeexxxxtttt Text mode, ignore images. The default is to
  507.             include the    images.
  508.  
  509.            uuuunnnnddddeeeerrrrlllliiiinnnneeee
  510.             Underline text that    constitutes a hypertext    link.
  511.             The    default    is to not underline.
  512.  
  513.            ccccoooolllloooouuuurrrr
  514.             Produce colour output for text and background,
  515.             when specified.  The default is black text on
  516.             white background (mnemonic:    coloUr ;-).
  517.  
  518.            vvvveeeerrrrssssiiiioooonnnn
  519.             Print information about the    current    version    of
  520.             html2ps.
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                        (printed 12/10/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  533.  
  534.  
  535.  
  536.            wwwweeeebbbb  Process a web of documents by recursively retrieve
  537.             and    convert    documents that are referenced with
  538.             hyperlinks.    When dealing with remote documents it
  539.             will of course be necessary    to impose
  540.             restrictions, to avoid downloading the entire
  541.             web... The value should be a string    consisting of
  542.             one    of the letters 'a', 'b', 'l', 'r', or 's',
  543.             optionally combined    with a combination of the
  544.             letters 'p', 'L', and a positive integer:
  545.  
  546.             aaaa     Follow    all links.
  547.             bbbb     Follow    only links to within the same
  548.              directory, or below, as the start document.
  549.             llll     Follow    only links specified with "<LINK
  550.              rel=NEXT>" in the document.
  551.             pppp     Prompt    for each remote    document. This mode
  552.              will automatically be entered after the first
  553.              50 documents.
  554.             rrrr     Follow    only relative links.
  555.             ssss     Follow    only links to within the same server
  556.              as the    start document.
  557.             LLLL     With this option, the order in    which the
  558.              documents are processed will be: first    all
  559.              top level documents, then the documents
  560.              linked    to from    these etc. For example,    if the
  561.              document A has    links to B and C, and B    has a
  562.              link to D, the    order will be A-B-C-D.    By
  563.              default, each document    will be    followed by
  564.              the first document it links to    etc; so    the
  565.              default order for the example is A-B-D-C.
  566.             ####     A positive integer giving the number of
  567.              recursive levels. The default is 4 (when the
  568.              option    is present).
  569.  
  570.            dddduuuupppplllleeeexxxx
  571.             Generate postscript    code for single    or double
  572.             sided printing.  No    default, valid values are:
  573.  
  574.             0000     Single    sided.
  575.             1111     Double    sided.
  576.             2222     Double    sided, opposite    page reversed (tumble
  577.              mode).
  578.  
  579.       The _m_a_r_g_i_n block
  580.            This block is used to specify page margins.
  581.  
  582.            lllleeeefffftttt An absolute    size of    the left margin, default is
  583.             2.5cm.
  584.  
  585.            rrrriiiigggghhhhtttt
  586.             An absolute    size of    the right margin, default is
  587.             2.5cm.
  588.  
  589.  
  590.  
  591.      Page 9                        (printed 12/10/98)
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  599.  
  600.  
  601.  
  602.            ttttoooopppp  An absolute    size of    the top    margin,    default    is
  603.             3cm.
  604.  
  605.            bbbboooottttttttoooommmm
  606.             An absolute    size of    the bottom margin, default is
  607.             3cm.
  608.  
  609.            mmmmiiiiddddddddlllleeee
  610.             An absolute    size for the distance between the
  611.             columns when printing two columns per page,
  612.             default is 2cm.
  613.  
  614.       The _x_r_e_f block
  615.            At every    hyperlink (to within the set of    converted
  616.            documents) it is    possible to have a cross reference
  617.            inserted. The _x_r_e_f block    is used    to control this
  618.            function.
  619.  
  620.            tttteeeexxxxtttt This defines the cross reference text to be
  621.             inserted; the symbol $N will expand    to the page
  622.             number, default is "[p $N]".
  623.  
  624.            ppppaaaasssssssseeeessss
  625.             The    number of passes used to insert    the cross
  626.             references.     Normally, only    one pass is run. But
  627.             since the insertion    of the page numbers may    effect
  628.             the    page breaks, it    might for large    documents with
  629.             many links be necessary with more than one pass to
  630.             get    the cross references right. The    default    is 1.
  631.  
  632.       The _q_u_o_t_e block
  633.            Language    specific quotation marks are defined in    this
  634.            block.  These quotation marks are used with the HTML
  635.            4.0 element Q for short quotations. Quotation marks for
  636.            a few languages are predefined, see below. It is
  637.            possible    to define different quotation marks for    quotes
  638.            within quotes.
  639.  
  640.            A quotation mark    is defined as a    string,    using the same
  641.            encoding    as the converted document (normally ISO-8859-
  642.            1), and/or with character entities.  Note that
  643.            quotation mark characters for several languages are not
  644.            included    in ISO-8859-1, and their corresponding
  645.            character entities were not been    defined    prior to HTML
  646.            4.0.
  647.  
  648.            Quotation marks for a language can be defined
  649.            explicitly in a sub-block of the    quote block. One can
  650.            also identify the set of    quotation marks    with another
  651.            previously defined language, using a key-value pair.
  652.            The sub-block/key name should equal the language    code
  653.            as defined in ISO 639. The language sub-block can have
  654.  
  655.  
  656.  
  657.      Page 10                        (printed 12/10/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  665.  
  666.  
  667.  
  668.            the following key-values:
  669.  
  670.             ooooppppeeeennnn The quote opening character(s).
  671.             cccclllloooosssseeee
  672.              The quote closing character(s). If undefined,
  673.              it will equal open.
  674.             ooooppppeeeennnn2222
  675.              The quote opening character(s)    for quotes
  676.              within    quotes.    If undefined, it will equal
  677.              open.
  678.             cccclllloooosssseeee2222
  679.              The quote closing character(s)    for quotes
  680.              within    quotes.    If undefined, it will equal
  681.              close.
  682.  
  683.            Example:    English    and Spanish use    the same set of
  684.            quotation marks - at least according to my book on
  685.            typography. These (already known    to html2ps) are
  686.            defined with:
  687.  
  688.           quote    {
  689.             en {
  690.               open: "“";
  691.               close: "”";
  692.               open2: "`";
  693.               close2: "'";
  694.             }
  695.             es:    en;
  696.           }
  697.  
  698.       The _t_o_c block
  699.            When a table of contents    (ToC) is generated from
  700.            document    headings and titles, the appearance is
  701.            controlled by this block.
  702.  
  703.            hhhheeeeaaaaddddiiiinnnngggg
  704.             A string with HTML code specifying a heading used
  705.             on the first ToC page. The symbols $T and $A can
  706.             be used for    the document title and author
  707.             respectively.
  708.  
  709.            lllleeeevvvveeeellll
  710.             The    maximum    heading    level used for building    the
  711.             ToC. The default is    6, which means that all
  712.             headings will generate ToC entries.
  713.  
  714.            iiiinnnnddddeeeennnntttt
  715.             The    ToC entries are    indented proportional to the
  716.             corresponding heading level. This value specifies
  717.             the    size of    the indentation.  The default is 1em.
  718.  
  719.            eeeexxxxttttrrrraaaappppaaaaggggeeee
  720.  
  721.  
  722.  
  723.      Page 11                        (printed 12/10/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  731.  
  732.  
  733.  
  734.             A flag specifying whether an extra (empty) page
  735.             should be printed between the ToC and the rest of
  736.             the    document, when necessary, to ensure that both
  737.             will start on an odd page. This is typically
  738.             desirable for double sided printing. The default
  739.             is 1.
  740.  
  741.       The _f_o_n_t block
  742.            Currently, html2ps recognizes the fonts:    Times, New-
  743.            Century-Schoolbook, Helvetica, Helvetica-Narrow,
  744.            Palatino, Avantgarde, Bookman, and Courier. To add a
  745.            new font    (family), choose a name    (consisting of
  746.            letters,    digits,    hyphens, and underscores) for the
  747.            font. Then define a sub-block to    the font block,    with
  748.            the same    name as    the chosen font    name. This block can
  749.            contain two key-value pairs:
  750.  
  751.             nnnnaaaammmmeeeessss
  752.              A string containing four PostScript font
  753.              names,    separated by whitespace, corresponding
  754.              to the    font styles normal, italic, bold, and
  755.              bold-italic. If less than four    names are
  756.              given,    the first is used for the missing
  757.              names.    Note that PostScript font names    are
  758.              case sensitive.
  759.             ffffiiiilllleeeessss
  760.              A string of four file names, separated    by
  761.              whitespace, for files containing font
  762.              definitions for the four font styles as
  763.              specified above.
  764.  
  765.            Example:    A font 'myfont'    has its    four font styles
  766.            defined in local    files.    To use this font in all    tables
  767.            in the converted    documents, one can use something like:
  768.  
  769.           TABLE    { font-family: myfont }
  770.  
  771.           @html2ps {
  772.             font {
  773.               myfont {
  774.             names: "MyFont-Roman MyFont-Italic MyFont-Bold
  775.             MyFont-BoldItalic";
  776.             files: "/x/y/myfr.ps /x/y/myfi.ps /x/y/myfb.ps
  777.             /x/y/myfbi.ps";
  778.               }
  779.             }
  780.           }
  781.  
  782.       The _h_y_p_h_e_n_a_t_i_o_n block
  783.            Hyphenation pattern files for different languages are
  784.            specified in sub-blocks within this block. The blocks
  785.            names should equal the language code as defined in ISO
  786.  
  787.  
  788.  
  789.      Page 12                        (printed 12/10/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  797.  
  798.  
  799.  
  800.            639. These language blocks can contain the following
  801.            two key-values:
  802.  
  803.             ffffiiiilllleeee A hyphenation pattern file in TeX format for
  804.              this language.
  805.             eeeexxxxttttffffiiiilllleeee
  806.              A file    containing a list of hyphenation
  807.              exceptions for    this language.    The exception
  808.              file should contain words, separated by
  809.              whitespaces, with hyphens inserted where
  810.              hyphenation is    allowed, as in:     "in-fra-
  811.              struc-ture white-space".
  812.  
  813.            For example, for    English    (with language code 'en') one
  814.            can have    a block    like:
  815.  
  816.               en {
  817.             file: "/opt/tex/lib/macros/hyphen.tex";
  818.             extfile: "/opt/tdb/lib/html2ps/enhyphext";
  819.               }
  820.  
  821.            The hyphenation block itself can    furthermore have these
  822.            key-values:
  823.  
  824.            mmmmiiiinnnn  A positive integer defining    the minimum number of
  825.             letters a word must    contain    to make    it a candidate
  826.             for    hyphenation.  The Default is 8.
  827.  
  828.            ssssttttaaaarrrrtttt
  829.             A positive integer defining    the minimum number of
  830.             letters that must precede the hyphen when a    word
  831.             is hyphenated.  The    default    is 4.
  832.  
  833.            eeeennnndddd  A positive integer defining    the minimum number of
  834.             letters that must follow the hyphen    when a word is
  835.             hyphenated.     The default is    3.
  836.  
  837.       The _h_e_a_d_e_r block
  838.            This block is used to specify page headers. It is
  839.            possible    to define left,    center,    and right headers.
  840.            Different headers for odd and even pages    can be
  841.            specified. Some symbols can be used that    will expand to
  842.            document    title, author, date, etc. See below.
  843.  
  844.            lllleeeefffftttt A left aligned header. If the alternate flag in
  845.             this block is set to 1, this will be the right
  846.             header on even pages.
  847.  
  848.            cccceeeennnntttteeeerrrr
  849.             A centered header.
  850.  
  851.            rrrriiiigggghhhhtttt
  852.  
  853.  
  854.  
  855.      Page 13                        (printed 12/10/98)
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  863.  
  864.  
  865.  
  866.             A right aligned header. If the alternate flag in
  867.             this block is set to 1, this will be the left
  868.             header on even pages.
  869.  
  870.            oooodddddddd----lllleeeefffftttt
  871.             A left aligned header on odd pages.
  872.  
  873.            oooodddddddd----cccceeeennnntttteeeerrrr
  874.             A centered header on odd pages.
  875.  
  876.            oooodddddddd----rrrriiiigggghhhhtttt
  877.             A right aligned header on odd pages.
  878.  
  879.            eeeevvvveeeennnn----lllleeeefffftttt
  880.             A left aligned header on even pages.
  881.  
  882.            eeeevvvveeeennnn----cccceeeennnntttteeeerrrr
  883.             A centered header on even pages.
  884.  
  885.            eeeevvvveeeennnn----rrrriiiigggghhhhtttt
  886.             A right aligned header on even pages.
  887.  
  888.            ffffoooonnnntttt----ffffaaaammmmiiiillllyyyy
  889.             The    font used for the header, default is
  890.             Helvetica.
  891.  
  892.            ffffoooonnnntttt----ssssiiiizzzzeeee
  893.             The    font size for the header, default is 8pt.
  894.  
  895.            ffffoooonnnntttt----ssssttttyyyylllleeee
  896.             The    default    is "normal".
  897.  
  898.            ffffoooonnnntttt----wwwweeeeiiiigggghhhhtttt
  899.             The    default    is "normal".
  900.  
  901.            ccccoooolllloooorrrr
  902.             The    header color, default is black.
  903.  
  904.            aaaalllltttteeeerrrrnnnnaaaatttteeee
  905.             A flag indicating whether the headers given    by the
  906.             left and right keys    should change place on even
  907.             pages. Typically used for double sided printing.
  908.             The    default    is 1.
  909.  
  910.       The _f_o_o_t_e_r block
  911.            This block is used to specify page footers. It is
  912.            possible    to define left,    center,    and right footers.
  913.            Different footers for odd and even pages    can be
  914.            specified. Some symbols can be used that    will expand to
  915.            document    title, author, date, etc. See below.
  916.  
  917.            lllleeeefffftttt A left aligned footer. If the alternate flag in
  918.  
  919.  
  920.  
  921.      Page 14                        (printed 12/10/98)
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  929.  
  930.  
  931.  
  932.             this block is set to 1, this will be the right
  933.             footer on even pages.
  934.  
  935.            cccceeeennnntttteeeerrrr
  936.             A centered footer.
  937.  
  938.            rrrriiiigggghhhhtttt
  939.             A right aligned footer. If the alternate flag in
  940.             this block is set to 1, this will be the left
  941.             footer on even pages.
  942.  
  943.            oooodddddddd----lllleeeefffftttt
  944.             A left aligned footer on odd pages.
  945.  
  946.            oooodddddddd----cccceeeennnntttteeeerrrr
  947.             A centered footer on odd pages.
  948.  
  949.            oooodddddddd----rrrriiiigggghhhhtttt
  950.             A right aligned footer on odd pages.
  951.  
  952.            eeeevvvveeeennnn----lllleeeefffftttt
  953.             A left aligned footer on even pages.
  954.  
  955.            eeeevvvveeeennnn----cccceeeennnntttteeeerrrr
  956.             A centered footer on even pages.
  957.  
  958.            eeeevvvveeeennnn----rrrriiiigggghhhhtttt
  959.             A right aligned footer on even pages.
  960.  
  961.            ffffoooonnnntttt----ffffaaaammmmiiiillllyyyy
  962.             The    font used for the footer, default is
  963.             Helvetica.
  964.  
  965.            ffffoooonnnntttt----ssssiiiizzzzeeee
  966.             The    font size for the footer, default is 8pt.
  967.  
  968.            ffffoooonnnntttt----ssssttttyyyylllleeee
  969.             The    default    is "normal".
  970.  
  971.            ffffoooonnnntttt----wwwweeeeiiiigggghhhhtttt
  972.             The    default    is "normal".
  973.  
  974.            ccccoooolllloooorrrr
  975.             The    footer color, default is black.
  976.  
  977.            aaaalllltttteeeerrrrnnnnaaaatttteeee
  978.             A flag indicating whether the footers given    by the
  979.             left and right keys    should change place on even
  980.             pages. Typically used for double sided printing.
  981.             The    default    is 1.
  982.  
  983.       The _f_r_a_m_e block
  984.  
  985.  
  986.  
  987.      Page 15                        (printed 12/10/98)
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  995.  
  996.  
  997.  
  998.            The appearance of the optional frame (drawn on each
  999.            page) is    controlled by this block.
  1000.  
  1001.            wwwwiiiiddddtttthhhh
  1002.             The    width of the frame, default is 0.6pt.
  1003.  
  1004.            mmmmaaaarrrrggggiiiinnnn
  1005.             The    size of    the frame margin, default is 0.5cm.
  1006.  
  1007.            ccccoooolllloooorrrr
  1008.             The    colour of the frame, default is    black.
  1009.  
  1010.       The _j_u_s_t_i_f_y block
  1011.            This block specifies the    maximum    amount of extra    space
  1012.            inserted    between    words and letters when text
  1013.            justification is    in effect.
  1014.  
  1015.            wwwwoooorrrrdddd Maximum amount of extra space inserted between
  1016.             words.  The    default    is 15pt.
  1017.  
  1018.            lllleeeetttttttteeeerrrr
  1019.             Maximum amount of extra space inserted between
  1020.             letters within words. The default is 0pt.
  1021.  
  1022.       The _d_r_a_f_t block
  1023.            It is possible to have some text    written    in a large
  1024.            font diagonally across each page. Typically this    is a
  1025.            word, written in    a very light colour, indicating    that
  1026.            the document is a draft.
  1027.  
  1028.            tttteeeexxxxtttt The    text to    be printed, default is "DRAFT".
  1029.  
  1030.            pppprrrriiiinnnntttt
  1031.             A flag specifying whether the draft    text should be
  1032.             printed or not.  If    unspecified, the draft text is
  1033.             printed when the document head contains <META
  1034.             name="Status" content="Draft">.
  1035.  
  1036.            ddddiiiirrrr  Specifies print direction, 0=downwards, 1=upwards.
  1037.  
  1038.            ffffoooonnnntttt----ffffaaaammmmiiiillllyyyy
  1039.             The    default    is Helvetica.
  1040.  
  1041.            ffffoooonnnntttt----ssssttttyyyylllleeee
  1042.             The    default    is "normal".
  1043.  
  1044.            ffffoooonnnntttt----wwwweeeeiiiigggghhhhtttt
  1045.             The    default    is "bold".
  1046.  
  1047.            ccccoooolllloooorrrr
  1048.             The    default    is "F0F0F0".
  1049.  
  1050.  
  1051.  
  1052.  
  1053.      Page 16                        (printed 12/10/98)
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  1061.  
  1062.  
  1063.  
  1064.       The _c_o_l_o_u_r block
  1065.            The 16 colour names from    the HTML 3.2 specification are
  1066.            recognized by html2ps. Use this block to    extend this
  1067.            list of colours.    This is    done with key-value pairs,
  1068.            where the key is    the colour name, and the value is the
  1069.            colour given as a hexadecimal RGB value,    for example:
  1070.            "brown: A52A2A;".
  1071.       KKKKeeeeyyyy----vvvvaaaalllluuuueeee ppppaaaaiiiirrrrssss iiiinnnn tttthhhheeee @@@@hhhhttttmmmmllll2222ppppssss bbbblllloooocccckkkk
  1072.  
  1073.       hhhhttttmmmmllll2222ppppssssrrrrcccc
  1074.            The name    of the default personal    configuration file.
  1075.            The default is $HOME/.html2psrc.
  1076.  
  1077.       iiiimmmmggggaaaalllltttt
  1078.            Specifies which text should be written as a replacement
  1079.            for in-line images when the IMG element has no ALT
  1080.            attribute.  The default is "[IMAGE]".
  1081.  
  1082.       ddddaaaatttteeeeffffmmmmtttt
  1083.            The symbol $D can be used in page headers and footers
  1084.            to insert the current date/time;    the value of the
  1085.            datefmt key specifies the format    used. The syntax is
  1086.            the same    as in the strftime(3) routine. The default is
  1087.            "%e %b %Y  %R", which gives a date string like "9 Aug
  1088.            1997  18:24".
  1089.  
  1090.       llllooooccccaaaalllleeee
  1091.            The locale (language code) used for formating language
  1092.            dependent parts of the date/time    in datefmt. If
  1093.            unspecified, the    value is taken from environment
  1094.            variables, see setlocale(3). No default.
  1095.  
  1096.       ddddoooocccc----sssseeeepppp
  1097.            A string    of HTML    code that will be inserted between the
  1098.            documents when more than    one are    converted. The default
  1099.            is "<!--NewPage-->", which will cause a page break. You
  1100.            may use (almost)    any HTML code, for example "<HR><HR>"
  1101.            or "<IMG    src=...>".
  1102.  
  1103.       bbbbaaaallllllll----rrrraaaaddddiiiiuuuussss
  1104.            The radius, given as a relative size, of    the balls used
  1105.            in unordered lists. The default is 0.25em.
  1106.  
  1107.       nnnnuuuummmmbbbbssssttttyyyylllleeee
  1108.            Page numbering style, 0=arabic, 1=roman.    The default is
  1109.            0.
  1110.  
  1111.       sssshhhhoooowwwwuuuurrrrllll
  1112.            When this flag is set to    1, the URL for external    links
  1113.            are shown within    parentheses after the link. The
  1114.            default is 0.
  1115.  
  1116.  
  1117.  
  1118.  
  1119.      Page 17                        (printed 12/10/98)
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  1127.  
  1128.  
  1129.  
  1130.       sssseeeeqqqq----nnnnuuuummmmbbbbeeeerrrr
  1131.            When this flag is set, the headings in the document
  1132.            will be sequentially numbered: H1 headings will be
  1133.            numbered    1, 2,..., H2 headings 1.1, 1.2,    etc. The
  1134.            default is 0.
  1135.  
  1136.       ffffoooorrrrmmmmssss
  1137.            This flag is used to specify whether FORM elements in
  1138.            the document should be processed    or ignored. Some forms
  1139.            may be suitable for printing out    and be filled out
  1140.            (with a pen), others are    not. The default is 1.
  1141.  
  1142.       tttteeeexxxxttttaaaarrrreeeeaaaa----ddddaaaattttaaaa
  1143.            When a TEXTAREA element contains    prefilled data,    the
  1144.            text will be used as labels if this flag    is set,
  1145.            otherwise ignored. The default is 1.
  1146.  
  1147.       ppppaaaaggggeeee----bbbbrrrreeeeaaaakkkk
  1148.            Set this    flag to    0 to suppress the normal behavior of
  1149.            generating page breaks form the comment <!--NewPage-->
  1150.            etc, as specified below.    The default is 1.
  1151.  
  1152.       eeeexxxxppppaaaannnndddd----aaaaccccrrrroooonnnnyyyymmmmssss
  1153.            A flag specifying whether acronyms, given by the
  1154.            ACRONYM element,    should be expanded or not. The default
  1155.            is 0.
  1156.  
  1157.       ccccoooollllllllaaaappppsssseeee----bbbbrrrr
  1158.            The default is 1.
  1159.  
  1160.       ssssppppooooooooffff
  1161.            Some web    servers    return different documents depending
  1162.            on which    user agent is used to retrieve the document.
  1163.            You can fool the    web server that    a certain browser is
  1164.            used, by    setting    this value to the identification used
  1165.            by the browser, such as "Mozilla/4.0". This only    works
  1166.            if you are using    one of the Perl    packages to retrieve
  1167.            remote documents.
  1168.  
  1169.      SSSSYYYYMMMMBBBBOOOOLLLLSSSS
  1170.       The following    symbols    can be used in page headers/footers:
  1171.  
  1172.            $$$$TTTT   Current document title.
  1173.            $$$$AAAA   Author of current document,    as specified with
  1174.             <META name="Author"    content="..."> in the document
  1175.             head.
  1176.            $$$$UUUU   The    URL or file name of current document.
  1177.            $$$$NNNN   Page number.
  1178.            $$$$HHHH   Current document heading (level 1-3).
  1179.            $$$$DDDD   Current date/time. The format is given by the
  1180.             datefmt key.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.      Page 18                        (printed 12/10/98)
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  1193.  
  1194.  
  1195.  
  1196.       To avoid symbol expansion, precede the dollar    sign with a
  1197.       backslash, as    in "\$T".
  1198.  
  1199.      HHHHIIIINNNNTTTTSSSS
  1200.       I imagine that a typical use of configuration    files can be
  1201.       something along the following    lines.
  1202.  
  1203.       System specific definitions (e.g. specification of available
  1204.       program packages) and    global defaults    (paper type etc) are
  1205.       defined in the global    configuration file.
  1206.  
  1207.       If there is more than    one user of the    program    on the system,
  1208.       each user can    also have a personal configuration file    with
  1209.       his/hers own personal    preferences.  (On a single user    system
  1210.       one can use the global configuration file for    this purpose
  1211.       as well.)
  1212.  
  1213.       One may also develop a collection of configuration files for
  1214.       typical situations. These files are placed in    a directory
  1215.       that is searched by html2ps (the search path is defined with
  1216.       the environment variable HTML2PSPATH).  For example, to
  1217.       print    a document as slides - in landscape mode, with large
  1218.       text in Helvetica, and a thick frame - one can create    a
  1219.       configuration    file, called 'slides' say, containing:
  1220.  
  1221.          @html2ps {
  1222.            option {
  1223.          landscape: 1;
  1224.          frame:    1;
  1225.            }
  1226.            frame { width: 3pt }
  1227.          }
  1228.          BODY {
  1229.            font-family: Helvetica;
  1230.            font-size: 20pt;
  1231.          }
  1232.          H1    { font-size: 35pt }
  1233.          H2    { font-size: 32pt }
  1234.          H3    { font-size: 29pt }
  1235.          H4    { font-size: 26pt }
  1236.          H5    { font-size: 23pt }
  1237.          H6    { font-size: 20pt }
  1238.          PRE { font-size: 18pt }
  1239.  
  1240.       Then use the command:
  1241.  
  1242.          html2ps -f    slides ...
  1243.  
  1244.       to convert the document. Note    that with this command the
  1245.       file 'slides'    is used    instead    of the personal    configuration
  1246.       file.    If you want both to be used, giving precedence to
  1247.       definitions made in the file 'slides', use the command:
  1248.  
  1249.  
  1250.  
  1251.      Page 19                        (printed 12/10/98)
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))    AAAAuuuuttttooooggggeeeennnneeeerrrraaaatttteeeedddd ((((9999 AAAAuuuugggg 1111999999997777))))      hhhhttttmmmmllll2222ppppssssrrrrcccc((((5555))))
  1259.  
  1260.  
  1261.  
  1262.          html2ps -f    :slides    ...
  1263.  
  1264.       (The page breaks between the slides can for example be
  1265.       generated by adding '<HR class=PAGE-BREAK>' to the HTML
  1266.       document.)
  1267.  
  1268.       For features that are    frequently turned on and off, and that
  1269.       cannot be controlled by command line options,    it may be a
  1270.       good idea to create small configuration files    as "building
  1271.       blocks". For example a file 'A4' for printing    on A4 paper
  1272.       (if you have some other default paper    type):
  1273.  
  1274.          @html2ps {    paper {    type: A4 } }
  1275.  
  1276.       and a    file 'hnum' for    automatic numbering of headings:
  1277.  
  1278.          @html2ps {    seq-number: 1 }
  1279.  
  1280.       Combining this with the previous example: to convert a
  1281.       document for printing    on A4 sized slides with    all headings
  1282.       numbered, use    the command:
  1283.  
  1284.          html2ps -f    :slides:A4:hnum    ...
  1285.  
  1286.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  1287.       html2ps(1), setlocale(3), strftime(3)
  1288.  
  1289.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  1290.       This manpage describes html2ps version 1.0 beta1.
  1291.  
  1292.      AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
  1293.       http://www.tdb.uu.se/~jan/html2ps.html
  1294.       ftp://ftp.tdb.uu.se/pub/WWW/html2ps/
  1295.  
  1296.      AAAAUUUUTTTTHHHHOOOORRRR
  1297.       Jan Karrman (jan@tdb.uu.se)
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.      Page 20                        (printed 12/10/98)
  1318.  
  1319.  
  1320.  
  1321.